home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d2
/
where41a.arc
/
WHEREIS.DOC
< prev
next >
Wrap
Text File
|
1990-10-26
|
42KB
|
1,035 lines
WhereIs Version 4.1a
Released Nov 1, 1990
A PC-DOS / MS-DOS Fast File Finder
Written by Keith Ledbetter
4240 Ketcham Drive
Chesterfield, VA 23832
(804) 674-0780
(6:00pm - 10:00pm Eastern Time)
Electronic mail on GEnie to ORION.MICRO
CompuServe to 72240,1221
Program and Documentation Copyright 1988, 1989, 1990 by Keith Ledbetter.
All rights reserved.
Portions Copyright Borland, International.
ACKNOWLEDGEMENTS
Special thanks to Herb Martin, Hal Hudler, Chris King, David
Essex, Arnold Kedy, and all of the other BETA testers for their
invaluable suggestions and debugging help. Also, special thanks
to the crowd on the Blue Ridge Express BBS system (804-790-1675)
for constantly prodding me to put in that "one other nice feature"
they'd like to see!
WhereIs is distributed as a Shareware program. Simply put, this
means that you may try out the program for a reasonable amount of
time, after which you will pay for the program if you find it of
use to you. Please help support the Shareware concept by paying
for and registering your copy. Please see the order form on the
following page. When you register your copy of WhereIs, you will
receive a "branding" utility that will allow you to brand all
future versions of WhereIs with your name and serial number. No
upgrade fees in the future; you only pay once!
WhereIs is written in Turbo C v2.0 by Borland, International.
WhereIs Registration Form Keith Ledbetter
4240 Ketcham Drive
Chesterfield, VA 23832
WhereIs Version 4.1a Quantity Price
Disk with branding utility ($15/copy): _______ __________
Total enclosed __________
Please make payment by check or money order (in US funds) payable
to "Keith Ledbetter".
Please specify the diskette size(s) that are acceptable for you:
___ 5.25" 1.2MB ___ 3.5" 1.44MB ___ 5.25" 360KB ___ 3.50" 720KB
Name ________________________________________________________
Company ________________________________________________________
Address ________________________________________________________
________________________________________________________
Phone ________________________________________________________
Where did you get WhereIs? ____________________________________
Multi-System and Reseller Licenses:
Site, corporate, network, and reseller licenses are available
for WhereIs. Check the line on the order form or contact me for
more information. The following schedule provides some
examples of multi-system license fees. The fee includes one
master diskette which you may then copy and use on the number
of machines listed below:
# Users Price
------- -------
5 $ 70.00 ($14 / copy)
10 130.00 ($13 / copy)
25 300.00 ($12 / copy)
50 550.00 ($11 / copy)
100 1,000.00 ($10 / copy)
Unlimited 1,500.00
WhereIs v4.1a Page 1
Introduction
Note: New features in this version are marked with an '|' beside them.
Thank you for taking the time to try out WhereIs v4.1a. You will find
that WhereIs can satisfy almost all of your file searching needs. It has
a multitude of search options, some of which are:
o The ability to search inside ARC, ZIP, PKA, PAK,
ZOO, and LZH archived files.
o True regular expression searching on filenames.
o The ability to display duplicate entries across all of
your disk drives (even those duplicates that are in the
archive files mentioned above!).
o Up to 25 filenames can be excluded from the search.
o Built-in ZIP archive error detection. Every time you
do a search that includes ZIP files, every ZIP file on
your hard drive is checked for integrity!
o The ability to do restrictive searches on such criteria
as file dates and file sizes.
o The ability to do a verified (or un-verified) deletion
of any files found in the search (great for periodically
deleting those .BAK files or files with a size of zero).
o Support for Novell's "volume" configurations.
o Default switches can be set in an environment variable.
Don't be fooled by imitations. There are recent file finder programs out
there making claims that their "features" are "never before found in any
file finder programs". Funny! Their "features" (like date-range searching
and filesize searching) have been in our program a YEAR before they were
even released!
Now, here is the only pitch that you'll see in this document for some of
your hard-earned money. WhereIs (as of v4.0) is now being distributed as
a Shareware product. If you find that you are still using this program a
couple of weeks after you get it, please take the time to fill out the
registration form at the front of this documentation file and send in your
registration fee of $15. This program has taken up a lot of my time over
the last two years (just ask my wife!...well, on second thought, you'd better
not..), and I feel that I can better support those people who are using
WhereIs by going this route. And, by the volumes of suggestions that I get
on the program, there must be quite a few of you out there! As of this
WhereIs v4.1a Page 2
Introduction
release, there will be (limited) telephone support for WhereIs to those users
who register their copies of WhereIs. I say limited because, like many other
Shareware authors, I make my "real" living by programming at a "real" job
during the day. Registered WhereIs users may call me at (804) 674-0780
between the hours of 6:00 pm - 10:00 pm (Eastern) Monday-Friday, and from
10 am - 6 pm on the weekends. Thank you for supporting WhereIs and my other
Shareware programs!
WhereIs v4.1a Page 3
What WhereIs Does
WHEREIS helps hard drive owners retain (some of) their sanity by locating
files on their hard drives. We've all had situations where we KNOW that a
file is somewhere on the hard drive; we just can't remember where. Another
added feature of WHEREIS is that it can be told to look inside of ARC files,
too. This is a very important feature with the common acceptance of archived
files these days. In this document, "ARC files" is used as a generic term
for any file with the following extension:
.ARC .ZIP .LZH .ZOO .PAK .PKA
Other advanced features of WHEREIS include (a) grep-type searching on
filenames (ie: find filenames with a '4' in the fifth character), (b) date
and time range specifiers, and (c) file size range specifiers. There are
many switches for WHEREIS, and it is highly recommended that you read this
document carefully so that you will be able to get the most out of the
program. There are very few things you can't do with WHEREIS when it comes
to locating files. As an advanced example:
whereis cde:*.bak "[0-9]" -gt1024 -lt2048 -s12-10-89 -b12-20-89 -v
How about THAT for a command line? What this would do is delete all .BAK
files on drives C:, D:, and E: that have a number somewhere in the filename
(ie: PROG01.BAK). But, only if the file is between 1025 and 2047 bytes in
length, and was last modified sometime between the dates of 12-10-89 and
12-19-89.
Yes, I know that you'll probably never need to do something exotic as
this, but it shows the power that you have with WHEREIS. Take the time to
learn WHEREIS, and it will always be your friend (sounds like Mr. Rogers!).
WhereIs v4.1a Page 4
The Command Line Interface
Invoking WHEREIS is simplicity itself. If you do not specify a path,
then WHEREIS will search the entire default drive. If you specify a
starting path, then the search will occur from that path downward (only).
Here are some basic command line examples:
whereis ab*.c search entire default drive for any filename
matching "ab*.c".
whereis \turboc\ab*.c search downward from the \turboc\ directory
on the default drive looking for "ab*.c".
whereis d:*.dat -a search entire drive d: and all ARC files
on drive d: looking for "*.dat".
whereis cd:*.dat -a search entire drive c: and drive d: and all
ARC files looking for "*.dat".
whereis myprog search entire default drive looking for
"myprog.*" (WHEREIS will append a ".*" to
a filename with no extender specified).
WhereIs v4.1a Page 5
Additional Command Line Switches
Switch: -A
Meaning: search all ARC files
Description: The '-a' switch tells WHEREIS to look in any ARC file
encountered for a matching filename. If a matching filename
is found, it will be displayed in parenthesis along with the
full name of the ARC file it resides in.
Switch: -AO
Meaning: search -ONLY- ARC files
Description: The '-ao' switch tells WHEREIS to ONLY look in any ARC file
encountered for a matching filename. If a matching filename
is found, it will be displayed in parenthesis along with the
full name of the ARC file it resides in.
Switch: -ARC -PAK -PKA -LZH -ZIP -ZOO
Meaning: search only the ARC formats specified
Description: These switches tell WHEREIS to only look inside the specified
ARC files for a matching filename. For example, if you are
sure that the file named MYPROG.EXE is somewhere on drive C:
in a .ZIP file, then
whereis c:myprog.exe -zip
would find the file. Specifying individual ARC format switches
slightly speeds up WHEREIS, because the program doesn't have to
waste time searching for (and through) all six ARC formats.
Switch: "regular expression"
Meaning: do a grep-type search on the filename
Description: Any command line string enclosed within double quotes will be
considered a regular expression, and will cause WHEREIS to go
into its "grep mode". A regular expression can be used with
or without a filename search mask.
| As of version 4.1a, when you specify a regular expression,
| WhereIs will also look inside of 4DOS description files for
| the string specified. If a match is found, the normal output
| line will be displayed, along with the actual 4DOS description
| line below the filename line.
Special characters within the quoted string are as follows:
^ - start matching at the first of the filename
? - match any character in this position
[..] - range check on character at this position
The easiest way to explain is with a few examples:
WhereIs v4.1a Page 6
Additional Command Line Switches
whereis *.bat
the regular search; will display any .BAT file found.
whereis *.bat "42"
will display any .BAT file that contains the characters
"42" anywhere in the filename.
whereis *.bat "^???42"
will display any .BAT file that contains the characters
"42" in the fourth position of the filename.
whereis "[0-9]"
will display any file that contains a number anywhere in
the filename.
whereis "[^0-9]"
will display any file that DOES NOT contain a number
anywhere in the filename.
whereis "^???a?[acew-z]"
will display any file that contains an 'a' in the fourth
position of the filename and the letters 'a', 'c', 'e',
'w', 'x', 'y', or 'z' in the sixth position of the name.
These grep masks also work when looking inside of ARC files.
| Switch: -C"command to execute"
| -O"command to display"
| Meaning: Execute (or display) a DOS command on all files found.
|Description: This switch tells WhereIs to execute the command within the
| double quotes on each matching file found. When doing this
| command, you have access to replaceable parameters to get to
| the full filename, the pathname only, the filename only, and
| the name of the archive member (if you're searching archives).
| The only difference between the -o and the -c switches is
| that -c actually executes the command whereas -o prints the
| command it WOULD have executed to the screen. Because of
| this, the -o command can be invaluable. First, you can use
WhereIs v4.1a Page 7
Additional Command Line Switches
| it before doing the -c command to make sure that what you
| think you told WhereIs to do is the same as what you DID
| tell it to do. In other words, if you're about to do a
| command that could have side effects (such as deleting files),
| it would be good to do the -o command first and look at what
| WhereIs actually will do when you execute the -c command.
| The second use of the -o command is to redirect all of the
| command lines into a batch file that you can execute later.
| Replacement parameters for both -c and -o are as follows:
|
| Parm Desc Normal example Archive example
| ---- ---- ----------------- -----------------
| &f full file name c:\dos\xcopy.exe c:\dos\comlib.zip
| &p path name only c:\dos\ c:\dos\
| &n file name only xcopy.exe comlib.zip
| &m archive member <blank> xcopy.exe
|
| A few examples would probably be the best way to explain this
| concept. Let's do a few "real-world" examples here.
|
| 1) You have many .DOC files straying all over your hard drive,
| and you'd like to incorporate them all into one simple
| ZIP file. You could do this with the following command:
|
| C:> whereis -d *.doc -c"pkzip -m c:\docs.zip &f"
|
| 2) You want to make a copy of all of your Pascal source code
| that has been changed today so that you can take it home
| with you:
|
| C:> whereis -d *.pas -s0 -c"copy &f a:\"
|
| 3) You want to get a text file listing of every directory
| name on your hard drive(s) in the file HARDDRIV.DAT:
|
| C:> whereis -d nul -o"&p" >c:\harddriv.dat
|
| 4) You want to delete every .BAK file on your system (even
| those that are in ZIP files). This would be a 2-step
| process:
|
| First, delete the normal .BAK files
|
| C:> whereis *.bak -v -n
|
| Then, delete them from the archive files
|
| C:> whereis -d -ao -zip *.bak -c"pkzip -d &f &m"
|
Switch: -D
Meaning: search all available hard drives.
WhereIs v4.1a Page 8
Additional Command Line Switches
Description: This switch tells WHEREIS to search every hard drive on your
system (including network drives), starting with C:. In other
words, if you have drives C:, D:, E:, and F: then the following
two command lines would do the exact same thing:
whereis cdef:myprog.exe
or
whereis myprog.exe -d
Switch: -DUP
Meaning: Display only duplicate filenames on the drives searched.
Description: If the -DUP switch is specified, only those files that have
duplicate entries will be displayed. All other switches are
active during -DUPlicate processing. For example, the
following command line:
whereis *.bat -a -d -dup
would cause WhereIs to search all hard drives (-d) looking for
duplicate .BAT files. WhereIs would also look inside of all
found Archive files (-a).
Switch: -E
Meaning: use "*.*" for subdirectory searches
Description: By default, WHEREIS assumes that you don't have any directories
on your hard drive that have extensions in the filename. So,
when WHEREIS is looking for new directories, it will search with
a filemask of "*.". This significantly speeds up the hard drive
search. If you do have directories that have extensions in their
names, you must specify the '-e' switch or WHEREIS -will not-
find files within that subdirectory. The easiest thing to do is
to set your WHEREIS environment variable to default to this
option (see "The WHEREIS Environment Variable" below).
Switch: -F
Meaning: display filenames only
Description: This switch causes WHEREIS to display only the filename of
matching files that it finds. No header or footer information
will be displayed. This is most useful when you are
redirecting the output from WHEREIS to a file.
Switch: -G
Meaning: go to the drive and subdirectory of the found file
Description: If you specify the '-g' switch, WHEREIS will prompt you with
Goto this subdirectory? _
whenever it finds a matching file. Press 'Y' to change to
the drive and subdirectory displayed, or 'N' to continue
WhereIs v4.1a Page 9
Additional Command Line Switches
searching the drive. You may also enter 'Q' to abort WHEREIS.
Switch: -H
Meaning: start searching in the current subdirectory
Description: The '-h' switch tells WHEREIS "start searching where I'm at
right now". For example, if you are currently in the TURBOC
subdirectory, then the following two commands would do the
exact same thing:
whereis \turboc\myprog.c
or
whereis myprog.c -h
With the '-h' switch, WHEREIS can be used as a directory
program with the ability to list ARC files. For example,
you could create the following batch file and call it
ARCDIR.BAT:
@echo off
whereis %1 -h -a
Now, when you give the command "ARCDIR", you will be shown
the directory listing, along with all files contained within
ARC files in your current subdirectory.
Switch: -I
Meaning: ignore the environment variable WHEREIS
Description: The '-i' switch tells WHEREIS to ignore any default switches
that you have set with the WHEREIS environment variable. This
is most useful if you have page-breaking set up as a default,
but need to redirect WHEREIS's output to a file. You could do
this with a command such as:
whereis *.bat -i >files.dat
Switch: -M -R
Meaning: modify WHEREIS's default output display
Description: These switches allow you to modify the way that WHEREIS
displays its output. By default, WHEREIS will place the
filename on the left of the screen (just like DIR does).
If you prefer, you can use '-M' to place the filename in the
middle of the screen, or '-R' to place the filename on the
right of the screen. Usually set in the environment.
Switch: -K
Meaning: search only the PATH directories
Description: This switch will cause WHEREIS to only search in the directories
that are specified in your DOS PATH environment variable.
WhereIs v4.1a Page 10
Additional Command Line Switches
This option will be used very rarely, but was requested by a
user.
| Note: As of v4.1a, this switch was changed. The '-K' switch was
| previously the '-C' switch.
Switch: -Y
Meaning: display the output with European-style dates (DD-MM-YY)
Description: Again, a seldom-used switch, but requested by a user.
Switch: -V [-N]
Meaning: do a verified delete of any matching files found
Description: These switches tell WHEREIS to delete any matching files found.
If you specify only the '-V' switch, then WHEREIS will prompt
you before it deletes each file. If you specify BOTH the '-V'
and the '-N' switch, then WHEREIS --WILL NOT-- prompt you; it
will just go ahead and delete the file (PLEASE be careful with
this one!). I use these switches daily to clean up all of the
.BAK files created by Turbo C. For example:
whereis *.bak -v -n
Switch: -W
Meaning: show wasted space occupied by matching files.
Description: This switch is used very little, but can come in handy if you
are trying to figure out how much disk space is being wasted
by a bunch of very small files (batch files are a prime
example). WHEREIS will total and display to you the amount of
disk space that is being wasted due to cluster overhead.
Switch: -U
Meaning: display all output in upper case
Description: Some people still prefer to see directory-type listings in
ALL UPPER CASE; if you're one of these people, then just use
the '-U' switch. It's best to set this in your WHEREIS
environment variable.
Switch: -P
Meaning: pause and wait for a key when the screen fills up
Description: A very handy switch, best used when set in your environment
variable. It will cause WHEREIS to pause the screen when it
fills up, so you don't have to go crazy trying to hit the
control-S key.
Switch: -Xfilemask
Meaning: exclude this filespec from the search
Description: The '-X' switch allows you to exclude certain filenames from
the directory search. You can specify up to 25 exclusion
WhereIs v4.1a Page 11
Additional Command Line Switches
masks. For example, if you wanted to see all files on your
drive except for .OBJ and .PRG files, you could do:
whereis *.* -x*.obj -x*.prg
Switch: -LT -EQ -GT
Meaning: specify a file size range
Description: These switches allow you to only search for files within a
certain size range. Some examples:
whereis *.PAS -LT1024
would display all .PAS files that have a size smaller than
1024 bytes.
whereis *.* -EQ0
would display all files that have a length of zero.
whereis *.* -GT500000
would display all files that are larger than 500,000 bytes.
whereis *.* -GT1023 -LT2049
would display all files that are between 1,024 and 2,048
bytes in size.
Switch: -S -B
Meaning: specify a file date range
Description: These switches allow you to only search for files within a
certain date range. These switches are the "since" (S)
switch and the "before" (B) switch. Both switches come in
two flavors; you can specify the date in number of days
(ie: -S5) or with a full date (ie: -S8-19-89). If you
specify either switch with no date specifier, then it defaults
to '0 days'. These date specifiers are also used when looking
inside of archive files. Some examples:
whereis *.PAS -S5
would display all .PAS files that have a date greater than or
equal to 5 days ago (in other words, modifed SINCE 5 days ago).
whereis *.PAS -S5-1-89
would display all .PAS files modified SINCE 5/1/89.
whereis *.PAS -B5
WhereIs v4.1a Page 12
Additional Command Line Switches
would display all .PAS files modifed BEFORE 5 days ago.
whereis *.PAS -B5-1-89
would display all .PAS files modified BEFORE 5/1/89.
whereis *.PAS -S5-1-89 -B6-1-89
would display all .PAS files modified between the dates of
5-1-89 and 5-31-89.
whereis *.PAS -S
would display all .PAS files that have been modified today
(defaults to '-S0').
Switch: -Z
Meaning: show only files with their archive bit set
Description: The '-Z' switch allows you to display only those files which
have their "archive bit" set on. In other words, it will show
all files that have been modified since your last backup (if
your backup program clears the archive bit, that is).
Switch: -HIDDEN
Meaning: also show hidden and system files
Description: The '-hidden' switch allows you to also display those files
which are "system" and "hidden" files.
WhereIs v4.1a Page 13
The WHEREIS and WI_DRIVES Environment Variables
When WHEREIS begins execution, it searches the environment for a variable
named WHEREIS. If this variable is present, its contents will be appended
onto the command line just as if you had entered them in from the keyboard.
This option is very handy for setting "default options" that you'd like for
WHEREIS to perform every time. Simply set the WHEREIS variable in your
AUTOEXEC.BAT file. For example, if you'd like to always (a) page break
when the screen fills up, (b) display the filenames on the right of the
screen, and (c) display output in upper case, you would put the following in
your AUTOEXEC.BAT file:
SET WHEREIS=-P -R -U
WHEREIS would then use these options every time you executed the program.
If you specify the "-d" switch (search all drives), then WHEREIS will
search the environment looking for a variable named WI_DRIVES. If this
variable is found, WHEREIS will use this list as the definition of the
drives to search. If the WI_DRIVES variable does not exist, WHEREIS will
use its own list, which defaults to drives c: through z: (ie: cde...z).
The WI_DRIVES variable was added mainly for those people using networks.
WHEREIS's reckless abandon of simply searching all drive letters caused
some network users a lot of headaches. It seems that those affected the
most were users of Novell networks. On Novell, you can specify many
different drive letters for the same "volume" (ie: partition), so WHEREIS
would show the same physical file many times, since WHEREIS thought that
it was really on a different drive. With the WI_DRIVES variable, it is
up to the user to tell WHEREIS what drives are physically different. For
example, let's assume that you have 3 volumes defined, and the drive letter
assignments are as follows:
Volume 1 - drives C: and D:
Volume 2 - drives E: and F:
Volume 3 - drives G: and H:
For WHEREIS to work correctly, you would put the following line in your
AUTOEXEC.BAT file:
Set WI_DRIVES=CEG
Now, when you search using the "-d" switch, WHEREIS won't list duplicate
filenames. I have never used a Novell network, so I'm hoping that this
change will eliminate the problems. This problem was brought up to me in
a letter from Bud Huddleston of Chamblee, GA. Luckily, he went into great
detail on what the problem was. The WI_DRIVES variable was the easiest
way I could think of to attack this problem. If this isn't the best way
to handle the situation, I'd appreciate it if you Novell users would drop
me a line with suggestions. Note that the search for the WI_DRIVES variable
CAN NOT be over-ridden from the command line. If the WI_DRIVES variable
WhereIs v4.1a Page 14
The WHEREIS and WI_DRIVES Environment Variables
exists, it is used every time. If you need to search a different list,
you must specify a drive list with the filename instead of using the "-d"
switch. For example, "whereis cdfg:*.bat".
For those users who are not on a network, you don't need to do anything
differently from version 3.5 of WHEREIS. If the WI_DRIVES variable isn't
defined, then v3.6 will perform exactly as v3.5 did.
WhereIs v4.1a Page 15
Duplicate Filename Searching
V4.0 of WhereIs incorporates a feature that I've been wanting for a very
long time - the ability to search all drives, including Archive files, and
display only those files that are duplicated somewhere else. This was a
fairly major upgrade to do, but it turned out (in my opinion) to be the best
added feature to WhereIs yet.
Maybe I'm worse than other people at this, but I'm terrible about doing a
download of a file, un-Arcing it, and then starting to use it. Of course,
the original of that file is still sitting out there somewhere in an Archive
file just eating up hard disk space.
With the new -DUP feature, cleaning up your multiple hard drives from any
duplicate files is much easier. But, be aware that when you invoke the -DUP
switch, WhereIs gets VERY memory-hungry. This is because WhereIs must keep
information on every filename on all of your hard drives (including all of
those filenames in any Archive files) in memory AT ONE TIME.
If you ever get the message "Error: out of memory!" when trying to find
duplicates across all drives, there are a couple of things that you can do.
First of all, see if you can free up any more memory by removing any TSR's
or device drivers. If you still get the "out of memory" message, then there
are two different things that you can do. The first is that you could
compare the drives two (or three) at a time. For example, if you
have drives C:, D:, E:, and F:, first compare drives C: and D:, then C: and
E:, etc. until you've scanned them all.
The second thing you can do (the way I prefer) is to do the duplicate scan
with a filemask; in other words, do the scan on *.EXE, then *.COM, then
*.BAT, etc. For example, here's a sample of what you'd do:
C:> whereis *.com -d -a
C:> whereis *.bat -d -a
C:> whereis *.exe -d -a
I don't see the "out of memory" being a problem except for those people
with HUGE hard drives. I have two 40-meg drives, both packed full of ZIP
files, and I never got close to filling up memory. In addition, WhereIs
is fairly intelligent when saving the names in memory; for example, if
you have 300 files in the path C:\TEST1\TEMP\DATA, the actual pathname
will only get saved one time. If you are looking for duplicates on a very
big hard drive system (let's say 80 meg or more), then WhereIs will take some
time. Don't be alarmed if the program seems to not be doing anything;
searching the file tables of very large hard drives takes some time. I
tinkered with the idea of putting in a twirling cursor or something so that
you'd know WhereIs was still alive, but I decided against it. Since
duplicate searching will probably be redirected to a printer or a disk file
most of the time, I didn't want to trash up the display.
WhereIs v4.1a Page 16
Duplicate Filename Searching
Don't forget that the -DUP switch works in tandem with ALL other WhereIs
switches. For example, specifying -DUP doesn't automatically scan all hard
drives and look inside all Archive files. You must still specify the -A and
-D switches. Also, filename exclusions still work just like normal.
Let's do a few examples:
C:> whereis -d -a -dup
This is the command you'll normally want to do when
searching for duplicates. It causes WhereIs to search
all hard drives, and inside Archive files, looking for
duplicates.
C:> whereis *.bat -d -a -dup
This command would only list the duplicate .BAT files
on your hard drives.
C:> whereis cd:*.* -a -dup -x*.bak -x*.doc
This command would display all duplicate files on drives
C: and D: except any .BAK or .DOC files.
WhereIs v4.1a Page 17
Change History
v1.0 o Initial release.
v1.1-1.7 o Internal testing changes.
v1.8 o Added the ability to specify multiple drives and filespecs
on the command line (ie: whereis cde:*.dat d:test.prg).
o Added the '-D' switch to search all drives.
o Added the '-E' switch to allow "*.*" use for directory
searches.
o Added the '-G' switch for "goto found subdirectory".
o Added the '-P' switch for page breaking.
o Added the '-V' switch for file deletion.
o Added support for the WHEREIS environment variable.
o Added the '-I' switch to ignore the environment variable.
v1.9 o Filenames are now searched for first in the current
directory instead of searching for subdirectories first.
v2.0 o Changed to the three different display formats.
o Enhanced Control-C checking to allow aborting at any time.
This was not the case in prior versions if a user didn't
have BREAK=ON specified in their AUTOEXEC.BAT file.
o Changed the '-G' switch to prompt the user before going
to the found subdirectory.
v2.1-2.3 o Internal testing changes.
v2.4 o Added the "European-style" date display, per a user's
request.
o Added the '-W' switch to show wasted space.
o Added the '-H' switch to display filenames only.
o Added ZIP file searching.
v2.5-2.6 o Internal testing changes.
v2.7 o Added LHARC file searching.
v2.8 o Added ZOO file searching.
v2.9 o Internal testing changes.
v3.0 o Changed the default display mode to put the filename on
the left of the screen.
o Added the ability to search specific ARC file formats.
o Added the '-AO' switch to search only archives.
o Added the '-F' to display filenames only.
o Changed the '-H' switch to start the search in the
current directory.
o Added the ability to exclude filenames with the
'-X' switch (up to 25 supported).
o Added the '-LT', '-EQ', and '-GT' switches for size
WhereIs v4.1a Page 18
Change History
range searching.
o Added the '-S' and '-B' switches for date range
searching.
o Added the '-C' switch for searching only the PATH
directories.
o Changed the '-W' switch to get the true cluster size
for each drive searched. Earlier versions simply
assumed a cluster size of 2048 bytes.
v3.1 o Fixed an obscure bug that would sometimes cause the
'date range' search to display files out of the range
if a file happenned to fall on the last day of any month
that had 31 days in it. All date range checks are now
done with Greenwich Mean Time for added accuracy.
v3.2-3.3 o Internal testing changes.
v3.4 o Added grep-type searching on filenames.
o Added a '-U' switch to display all output in upper
case.
o Changed so that if you don't specify at least one
filespec on the command line, the default will be "*.*".
For example, in earlier versions you would have to say
"whereis *.* -s". Now you can just say "whereis -s".
v3.5 o Sped up ZIP searching by 50% due to a new method of
locating the "central directory".
o Sped up "grep" searching through archives by almost 70%.
o Added a '-z' switch, which only displays files that have
their "archive bit" set (ie: displays files modified
since your last backup was made).
v3.6 o Added the "-hidden" switch which informs WHEREIS to
include system and hidden files in the search.
o Added the optional WI_DRIVES environment variable to
hopefully alleviate some of the problems that occur
when WHEREIS is used on a Novell network.
v3.7 o Sped up the grep searching slightly.
o ZIP searching now does a much better job of looking
for "corrupted" ZIP files.
v3.8 o These version numbers were skipped.
v3.9
v4.0 o Added the ability to display only duplicate filename
entries.
o v4.0 marks the beginning of Shareware marketing.
o The program will no longer pause with the "More"
message if WhereIs detects that the output is being
redirected to a file or a printer.
WhereIs v4.1a Page 19
Change History
v4.1a o Added the ability to execute a DOS command on any file
matches found.
o When you specify a "grep mask", WhereIs will now also
search inside of 4DOS's description files.
End of document.